home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / system / shcpy201.zip / TCOPY.DOC < prev    next >
Text File  |  1994-11-16  |  13KB  |  378 lines
  1.  
  2.  
  3.  
  4.                                     TRU-COPY
  5.                                   Release 2.0
  6.  
  7.                                        by
  8.                                   W.G. Madison
  9.  
  10.                        W.G. Madison and Associates, Ltd.
  11.                        Consultants / Information Systems
  12.                               13819 Shavano Downs
  13.                            San Antonio, TX 78230-5811
  14.                                  (210)492-2776
  15.                           (Internet bmadison@crl.com)
  16.                        (FIDOnet  bill madison 1:387/800)
  17.                             (CompuServe  73240,342)
  18.  
  19.  
  20.        PURPOSE:
  21.  
  22.             The DOS COPY command has three major shortcomings:
  23.  
  24.           1.  DOS provides no facility for reliably verifying the valid-
  25.               ity of a file copying operation. The use of the DOS VERIFY
  26.               command or the /V switch on the COPY command parform a
  27.               check which is essentially valueless, particularly in the
  28.               presence of disk caching.
  29.  
  30.               Normally, the only way to assure that the recording was
  31.               correct is to read the file after writing, and compare
  32.               (using, e.g., COMP) the output file byte for byte with the
  33.               input. For very long files this can result in unacceptable
  34.               delays.
  35.  
  36.           2.  When using the DOS COPY command, files are copied uncondi-
  37.               tionally -- possibly accidentally overwriting existing
  38.               files.
  39.  
  40.           3.  When using the usual DOS facilities, files can only be
  41.               moved from one subdirectory to another through a two step
  42.               process. First, the file must be COPY'd to the target
  43.               subdirectory; and second, it must be DELeted from the
  44.               source subdirectory.
  45.  
  46.             TRU-COPY answers these three problems in a single efficient
  47.        program.
  48.  
  49.           1.  Whenever TRU-COPY copies a file, the source file's cyclic
  50.               redundency check (CRC) value is calculated during the
  51.               copying process. On completion of the copying, the desti-
  52.               nation file is read and the CRC re-calculated. If the two
  53.               do not compare, a warning is issued, the source file is
  54.  
  55.  
  56.  
  57.               unconditionally preserved, and the destination file is
  58.               deleted.
  59.  
  60.               TRU-COPY preserves the date/time stamp of the source file
  61.               in the destination file.
  62.  
  63.           2.  Whenever TRU-COPY copies a file, it first checks to see if
  64.               a file of the same name already exists in the target sub-
  65.               directory. If it does, the user is presented with the
  66.               option of allowing the copying to proceed, or skipping
  67.               that copy and proceeding to the next. (TRU-COPY can,
  68.               however, be directed to perform the copies uncondition-
  69.               ally, by use of a command line switch.)
  70.  
  71.           3.  TRU-COPY can also be instructed (again, using a command
  72.               line switch) to move a file from one subdirectory to
  73.               another. This action proceeds by the following rules:
  74.  
  75.                  a.  If the source and destination subdirectories are on
  76.                      the same device, then
  77.  
  78.                         i.  If a file of the same name exists in the
  79.                             target subdirectory, then TRU-COPY will
  80.                             revert to the copying mode described above.
  81.                             In this case, however, the file will be
  82.                             deleted from the source subdirectory after
  83.                             successful verification.
  84.  
  85.                        ii.  If no file of the same name exists in the
  86.                             target subdirectory, the file will be moved
  87.                             directly, without copying.
  88.  
  89.                  b.  If the source and destination directories are on
  90.                      different devices, the MOVE will be accomplished by
  91.                      a COPY, VERIFY, DELETE sequence as described above.
  92.  
  93.           4.  Beginning with release 2.0, when performing a MOVE (as
  94.               described above) TRU-COPY recognizes subdirectories in
  95.               SUBSTed, JOINed, or ASSIGNed drives, and will act
  96.               accordingly.
  97.  
  98.  
  99.        HISTORY AND BACKGROUND:
  100.  
  101.             For those unfamiliar with CRCs, suffice to say that they are
  102.        very powerful generalizations of the more familiar 'parity check'
  103.        schemes, such as those which have been used at least since the
  104.        early days of digital magnetic tape recording.
  105.  
  106.  
  107.                                       -2-
  108.  
  109.  
  110.  
  111.             As such, calculating the CRC of a block of data prior to its
  112.        transmission and again following transmission, and then comparing
  113.        the results of the two calculations, provides an excellent indi-
  114.        cation of whether the transmission process introduced any errors
  115.        into the data.
  116.  
  117.  
  118.        USAGE:
  119.  
  120.             The syntax is similar to the DOS COPY command, except that
  121.        files cannot be concatenated during the copying process.
  122.  
  123.        Usage is:
  124.                 TCOPY [/[D][O]] [s-path]s-file [d-path][d-file]
  125.  
  126.        where
  127.             [/D]      is the optional delete-source-file switch
  128.             [/O]      unconditionally overwrites existing target files
  129.             [s-path]  is the optional source path (directory)
  130.             [d-path]  is the optional destination path (directory)
  131.             s-file    is the source file specification
  132.             [d-file]  is the optional destination file specification
  133.  
  134.        Notes:
  135.  
  136.           1.  If either path is omitted, the current path on the
  137.               appropriate device is assumed.
  138.  
  139.           2.  Path names may be either absolute or relative. For
  140.               example,
  141.                                          D:*.*
  142.  
  143.               refers to all of the files in the current directory of
  144.               disk D:, and
  145.                                        FOO\BAZ.*
  146.  
  147.               refers to all files named BAZ (regardless of the exten-
  148.               sion) in subdirectory FOO of the current directory.
  149.  
  150.               For additional information concerning path names, please
  151.               refer to your DOS manual.
  152.  
  153.           3.  If [d-file] is omitted, *.* is assumed; i.e., the files
  154.               will be transferred with their names and extensions
  155.               preserved.
  156.  
  157.           4.  Files cannot be copied to themselves. Therefore,
  158.  
  159.                                     [s-path]s-file
  160.  
  161.                                       -3-
  162.  
  163.  
  164.  
  165.               cannot refer to the same file as
  166.  
  167.                                    [d-path][d-file]
  168.  
  169.           5.  TRU-COPY preserves the date/time of the source file.
  170.  
  171.  
  172.        SYSTEM REQUIREMENTS:
  173.  
  174.             Hardware: PC/XT/AT or close compatible.
  175.             Software: DOS 2.0 and above. TRU-COPY uses some undocumented
  176.        features of DOS. It cannot, therefore, be guaranteed to work in
  177.        other environments (e.g., DR-DOS). The features used are, how-
  178.        ever, supposedly supported in the DOS compatibility mode of OS/2.
  179.        This has not been tested, however.
  180.  
  181.  
  182.        INSTALLATION:
  183.  
  184.             If you are using DOS 2.x, TCOPY ***MUST*** be installed in
  185.        one of the directories specified in your PATH, and ***MUST NOT***
  186.        be renamed to anything else. If you are unfamiliar with the PATH
  187.        concept, please refer to your DOS reference manual.
  188.  
  189.             If you are using DOS 3.x or later, these restrictions do not
  190.        apply. TCOPY may be installed anywhere, and renamed to anything.
  191.  
  192.  
  193.        AND FINALLY:
  194.  
  195.            -  The software described herein and the accompanying
  196.               documentation is copyrighted and the sole the property of
  197.               W. G. Madison and Associates, Ltd. All rights reserved.
  198.  
  199.            -  W. G. Madison and Associates, Ltd. reserves the right to
  200.               make improvements in the product described in this
  201.               documentation and/or to the documentation at any time and
  202.               without notice.
  203.  
  204.        Distribution
  205.             TRU-COPY is specifically authorized for distribution on
  206.        public electronic bulletin boards, by individual copying, or by
  207.        ASP designated distributors. Any distribution thus made must be
  208.        in the form of this entire .ZIP file, including both the program
  209.        executable file and this documentation file. NO DISTRIBUTION FOR
  210.        A FEE (other than a nominal copying charge), IS AUTHORIZED
  211.        WITHOUT SPECIFIC WRITTEN PERMISSION OF THE COPYRIGHT HOLDER.
  212.  
  213.  
  214.  
  215.                                       -4-
  216.  
  217.  
  218.  
  219.        Limited Warranty
  220.             THE PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  221.        KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
  222.        THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  223.        PARTICULAR PURPOSE. THE ENTIRE RISK AS TO QUALITY AND PERFORMANCE
  224.        OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
  225.        YOU ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR
  226.        CORRECTION. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED
  227.        WARRANTIES SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS
  228.        WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE
  229.        OTHER RIGHTS WHICH VARY FROM STATE TO STATE.
  230.  
  231.        Limitation of Remedies
  232.             IN NO EVENT WILL W. G. MADISON AND ASSOCIATES, LTD. BE
  233.        LIABLE FOR ANY DAMAGES INCLUDING ANY LOST PROFITS, LOST SAVINGS
  234.        OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  235.        USE OR INABILITY TO USE SUCH PROGRAM EVEN IF W. G. MADISON AND
  236.        ASSOCIATES, LTD. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  237.        DAMAGES OR ANY CLAIM BY ANY OTHER PARTY.
  238.  
  239.        License
  240.             A limited license is granted to any user of the program to
  241.        freely copy and distribute the product subject to the following
  242.        restrictions:
  243.  
  244.             You may not:
  245.  
  246.            -  Sell and/or distribute the product for a fee, either alone
  247.               or along with other products, without express written per-
  248.               mission.
  249.  
  250.            -  Grant sublicense, leases, or other rights in the software
  251.               to others.
  252.  
  253.            -  Modify or remove the Copyright notice from the program,
  254.               diskette or the documentation.
  255.  
  256.            -  Modify the program, diskette or documentation and/or merge
  257.               it into another program for any machine.
  258.  
  259.        Support
  260.             Users are provided full telephone support. A recorder is
  261.        provided on the telephone number listed above, in case no one is
  262.        in the office, and a callback will normally occur no later than
  263.        the next business day. Bug fixes or work-arounds will be mailed
  264.        to the complainant and will also be uploaded to CIS (IBMSYS) and
  265.        to major BBS's in the metropolitan San Antonio area.
  266.  
  267.  
  268.  
  269.                                       -5-
  270.  
  271.  
  272.  
  273.        Contact
  274.             Telephone contact may normally be made between the hours of
  275.        7:00AM and 9:00PM (Central time), but see above. Users will be
  276.        accommodated on a "time available" basis. Contact may, of course,
  277.        always be made at any of the network addresses given above. All
  278.        users are encouraged to submit comments about this program by
  279.        filling out the comment form on the following page, and mailing
  280.        it to the address indicated.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                                       -6-
  324.  
  325.  
  326.  
  327.                               WGM&AL Comment Form
  328.                                     TRU-COPY
  329.  
  330.  
  331.        Name:___________________________________________________________
  332.  
  333.        Company:________________________________________________________
  334.  
  335.        Address:________________________________________________________
  336.  
  337.        City:__________________________ State:_____  ZIP _______________
  338.  
  339.        Telephone:(_____) _____-_______
  340.  
  341.        TRU-COPY Version:_____._____
  342.  
  343.        Comments:
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.        Mail To:
  372.  
  373.                       W. G. Madison and Associates, Ltd.
  374.                               13819 Shavano Downs
  375.                           San Antonio, TX 78230-5811
  376.                                  (512)492-2776
  377.  
  378.